---
title: 检查器
description: 使用 MCP 检查器测试和调试模型上下文协议服务器的深入指南
---

[MCP 检查器](https://github.com/modelcontextprotocol/inspector) 是一个交互式开发者工具，用于测试和调试 MCP 服务器。虽然 [调试指南](/docs/tools/debugging) 将检查器作为整体调试工具包的一部分进行了介绍，但本文档提供了对检查器功能和能力的详细探索。

## 开始使用

### 安装和基本用法

检查器通过 `npx` 直接运行，无需安装：

```bash
npx @modelcontextprotocol/inspector <命令>
```

```bash
npx @modelcontextprotocol/inspector <命令> <参数1> <参数2>
```

#### 从 NPM 或 PyPi 检查服务器

从 [NPM](https://npmjs.com) 或 [PyPi](https://pypi.com) 启动服务器包的常见方式。

<Tabs>

  <Tab title="NPM 包">
  ```bash
  npx -y @modelcontextprotocol/inspector npx <包名> <参数>
  # 例如
  npx -y @modelcontextprotocol/inspector npx server-postgres postgres://127.0.0.1/testdb
  ```
  </Tab>

  <Tab title="PyPi 包">
  ```bash
  npx @modelcontextprotocol/inspector uvx <包名> <参数>
  # 例如
  npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git
  ```
  </Tab>
</Tabs>

#### 检查本地开发的服务器

要检查本地开发或作为仓库下载的服务器，最常见的方式是：

<Tabs>
  <Tab title="TypeScript">
  ```bash
  npx @modelcontextprotocol/inspector node path/to/server/index.js 参数...
  ```
  </Tab>
  <Tab title="Python">
  ```bash
  npx @modelcontextprotocol/inspector \
    uv \
    --directory path/to/server \
    run \
    包名 \
    参数...
  ```
  </Tab>
</Tabs>

请仔细阅读附带的 README 以获取最准确的说明。

## 功能概览

<Frame caption="MCP 检查器界面">
  <img src="/images/mcp-inspector.png" />
</Frame>

检查器提供了多种与您的 MCP 服务器交互的功能：

### 服务器连接面板
- 允许选择连接服务器的 [传输方式](/docs/concepts/transports)
- 对于本地服务器，支持自定义命令行参数和环境

### 资源选项卡
- 列出所有可用资源
- 显示资源元数据（MIME 类型、描述）
- 允许检查资源内容
- 支持订阅测试

### 提示选项卡
- 显示可用的提示模板
- 显示提示参数和描述
- 支持使用自定义参数测试提示
- 预览生成的消息

### 工具选项卡
- 列出可用工具
- 显示工具模式和描述
- 支持使用自定义输入测试工具
- 显示工具执行结果

### 通知面板
- 显示从服务器记录的所有日志
- 显示从服务器收到的通知

## 最佳实践

### 开发工作流程

1. 开始开发
   - 使用您的服务器启动检查器
   - 验证基本连接性
   - 检查能力协商

2. 迭代测试
   - 修改服务器
   - 重建服务器
   - 重新连接检查器
   - 测试受影响的功能
   - 监控消息

3. 测试边界情况
   - 无效输入
   - 缺少提示参数
   - 并发操作
   - 验证错误处理和错误响应

## 下一步

<CardGroup cols={2}>
    <Card
        title="检查器仓库"
        icon="github"
        href="https://github.com/modelcontextprotocol/inspector"
    >
        查看 MCP 检查器的源代码
    </Card>

    <Card
        title="调试指南"
        icon="bug"
        href="/docs/tools/debugging"
    >
        了解更广泛的调试策略
    </Card>
</CardGroup>